UML, часть 1: нотация и структура системы
- О чём эта тема
- Единый графический язык проектирования – UML: зачем он нужен команде, из каких элементов состоит его нотация и как читать и рисовать три диаграммы «статики»: вариантов использования, классов и компонентов. Плюс редактор диаграмм прямо на странице и командный практикум с карточками.
- Аннотация
- Конспект начинается с проблемы: между идеей и кодом лежит пропасть, и команда теряется в ней, когда у каждого свои слова для одних и тех же вещей. UML предлагается как общий язык: расшифровка названия, краткая история, три режима использования – набросок, чертёж и язык программирования – и честный разговор о том, зачем диаграммы нужны в 2026 году, когда код пишет нейросеть. Второй раздел даёт карту четырнадцати видов диаграмм. Третий – нотацию: класс и объект, интерфейс, компонент и узел, вариант использования и актор, пакет, заметка, связи, стереотипы и рамка; элементы закрепляются карточной игрой. Четвёртый раздел посвящён диаграмме вариантов использования: как искать акторов и цели, когда ставить «include» и «extend», какие ошибки делают почти все новички. Пятый разбирает диаграмму классов до уровня синтаксиса атрибутов, кратностей, агрегации и композиции, интерфейсов и диаграммы объектов. Шестой – диаграммы архитектуры: компонентов, развёртывания и пакетов. Седьмой сравнивает инструменты: редактор курса, draw.io, текстовые PlantUML и Mermaid. Завершают конспект командный практикум с карточками, свод практик и контрольные вопросы. Продолжение – на занятии 8: диаграммы поведения.
- Пререквизиты
- Из занятия 6 понадобятся репозиторий команды и README: диаграммы этого занятия кладутся туда. Из занятия 5 – привычка проверять, а не верить: она пригодится, когда диаграмму нарисует нейросеть. Знание языка программирования не требуется: UML к языкам не привязан.
- Мотивация
- Между идеей и кодом лежит пропасть глубиной в десятки часов реализации: легко сбиться, отклониться от задумки, пойти на компромисс – и получить не то, что планировалось. Задача усложняется многократно, когда образ проекта нужно согласовать с командой, а отдельное удовольствие – согласовать его с заказчиком, который не обязан понимать технические детали. Даже внутри команды аналитик, фронтендер и бэкендер часто называют одни вещи разными словами. Если бы все могли общаться на одном однозначном языке, работа упростилась бы радикально – и такой язык есть. Он же пригодится в отчёте по практике и в выпускной работе: диаграмма вариантов использования обычно открывает главу о требованиях, диаграммы классов и развёртывания – главу о проектировании.
1. Что такое UML
Начнём с того, что происходит в команде из четырёх человек на второй неделе проекта. Каждый держит в голове свою картину будущей программы, и картины эти не совпадают: один думает о экранах, другой о таблицах, третий о классах. Разговор о «заказе» или «игроке» идёт по кругу, пока кто-нибудь не возьмёт маркер и не нарисует на доске прямоугольники со стрелками. Рисунок за минуту делает то, чего не сделал часовой разговор: все смотрят на одно и то же. UML – это договорённость о том, как такие рисунки рисовать, чтобы их понимал не только автор.
UML (Unified Modeling Language, унифицированный язык моделирования) – язык графического описания для объектного моделирования в разработке программного обеспечения, применимый также к моделированию бизнес-процессов, системному проектированию и отображению организационных структур. По схемам UML участники команды – продакты, аналитики, программисты – видят систему на одном языке и понимают друг друга без погружения в код.
UML не привязан к языкам программирования: команда может писать на Java, Python или C# – безразлично. Более того, программирования может не быть вовсе: в бизнесе диаграммами UML изображают согласование договора или обработку жалобы, в производстве – последовательность создания продукта, в логистике – путь товара от склада до клиента.
Расшифровка названия объясняет устройство языка:
- U – Unified. Унифицированный: язык снял различия между нотациями нескольких методов проектирования, существовавших до него, и дал единую точку зрения на разные виды систем – от бизнес-процесса до программы – и на разные фазы разработки.
- M – Modeling. Диаграммы – это модели: наполненные информацией и связанные между собой графические объекты. Модель всегда беднее системы, и в этом её смысл: она показывает одно и прячет остальное.
- L – Language. UML – искусственный язык со словарём (графические символы), семантикой (смысл элементов) и синтаксисом (правила построения). В него заложены даже генерация кода из модели и восстановление модели из кода.
1.1. Откуда взялся UML
До середины 1990-х в объектно-ориентированном моделировании конкурировали несколько методов – OMT, метод Буча, OOSE – с разными обозначениями, и это время называют «войной методов»: каждый инструмент понимал только свою нотацию. В 1994 году Джеймс Рамбо, автор OMT, перешёл в компанию Rational Software к Гради Бучу; осенью 1995 года к ним присоединился Ивар Якобсон, автор OOSE и понятия «вариант использования». Первый черновик объединённого метода вышел в октябре 1995 года, название UML появилось в 1996-м, а 14 ноября 1997 года консорциум OMG утвердил UML 1.1 как стандарт. UML 2.0 (2005) перестроил язык почти заново; актуальная версия – UML 2.5.1, опубликованная в декабре 2017 года и до сих пор действующая. Спецификация доступна на сайте OMG (см. «Источники»), на международном уровне ей соответствует стандарт ISO/IEC 19505:2012, описывающий более раннюю версию 2.4.1.
1.2. Три режима: набросок, чертёж, язык программирования
Прежде чем учить нотацию, стоит решить, в каком режиме UML будет использоваться, – от этого зависит, насколько точно нужно рисовать. Режимов три, и различаются они не картинками, а целью.
Набросок рисуют за несколько минут на доске или в редакторе, чтобы обсудить одну идею: как устроены классы заказа, кто пользуется системой, через какие серверы идёт запрос. Набросок выборочен – на нём только то, что важно для разговора, – и живёт столько, сколько длится разговор; потом его фотографируют или перерисовывают в репозиторий.
Чертёж – полная модель, по которой программист пишет код, не задавая вопросов. Чертёж требует инструмента, дисциплины и постоянного обновления: как только код ушёл вперёд, чертёж начинает врать.
Язык программирования – модель, из которой код генерируется целиком. Такой режим работает в узких областях вроде встроенных систем, а в массовой разработке не прижился.
Именно второй и третий режимы имели в виду авторы статей с заголовками «UML умер». Опрос пятидесяти инженеров из пятидесяти компаний показал, что тридцать пять из них не используют UML вовсе, одиннадцать – выборочно, три – для генерации кода и ни один – целиком. Выборочное использование – это и есть набросок: пара диаграмм, нарисованных ради одного разговора. В этом режиме UML живёт и в 2026 году, и именно ему посвящены занятия 7 и 8.
1.3. Зачем UML, когда код пишет нейросеть
Вопрос, который задаёт каждая команда: если ИИ-агент пишет код по словесному описанию, зачем тратить час на прямоугольники? Ответ в том, что именно агент делает хуже всего. Исследования 2023–2025 годов измерили это: в сгенерированных диаграммах классов сами классы находятся неплохо, связи между ними – плохо (точность около трети), а в диаграммах вариантов использования модель уверенно перечисляет варианты, но путает «include» и «extend», выдумывает акторов и пропускает настоящих. Решения о границах системы, ролях, сущностях и их связях остаются за командой – и их нужно уметь записать так, чтобы и человек, и ИИ прочли одно и то же.
Отсюда три практических следствия.
- Чтобы проверить сгенерированную диаграмму или код, нужно читать диаграмму: иначе не заметить лишнего актора, перевёрнутую стрелку или неверную кратность.
- Диаграмма – общий артефакт для четырёх читателей: команды, преподавателя, отчёта и ИИ-ассистента. Текстовые нотации (раздел 7.3) ИИ читает напрямую.
- Одна страница диаграммы в репозитории – дешёвый способ договориться до того, как агент сгенерирует тысячу строк в неверной структуре. Прямого измерения, насколько именно UML-диаграмма в запросе улучшает код, в литературе пока нет; есть данные, что план перед кодом улучшает результат генерации, – диаграмма и есть такой план.
Итак, UML нужен как общий язык для разговора и как способ проверить чужую работу. Из какого словаря этот язык состоит – в следующих двух разделах.
2. Карта диаграмм UML
В UML 2.5.1 четырнадцать видов диаграмм, и спецификация делит их на две группы по тому, о чём они говорят: из чего система состоит или что в ней происходит.
Структурные диаграммы описывают систему статически – из чего она состоит:
| Диаграмма | Описание |
|---|---|
| Классов (Class) | Система как набор классов: свойства, методы, взаимосвязи. |
| Объектов (Object) | Снимок диаграммы классов с конкретными значениями свойств. |
| Пакетов (Package) | Взаимосвязи пакетов – групп классов, упрощающих сложную диаграмму. |
| Компонентов (Component) | Архитектура компонентов (сервисы, интерфейсы, приложения) и зависимости между ними. |
| Развёртывания (Deployment) | Система с точки зрения физического размещения: серверы, устройства, файлы. |
| Профилей (Profile) | Пользовательские стереотипы и ограничения моделей. |
| Композитной структуры | Внутреннее устройство классов и взаимодействие их частей. |
Поведенческие диаграммы описывают систему динамически – как она живёт во времени:
| Диаграмма | Описание |
|---|---|
| Вариантов использования (Use Case) | Цели, которых внешние участники – акторы – достигают с помощью системы. Употребляется и термин «диаграмма прецедентов». |
| Деятельности (Activity) | Рабочий процесс: шаги, развилки, параллельные ветки. |
| Состояний (State Machine) | Состояния объекта и правила переходов между ними. |
| Последовательности (Sequence) | Обмен сообщениями между объектами в хронологическом порядке. |
| Коммуникации (Communication) | То же взаимодействие, но без раскрытия хронологии. |
| Синхронизации (Timing) | Поведение объектов на временной шкале. |
| Обзора взаимодействия | Высокоуровневый процесс, где каждый узел – другая диаграмма взаимодействия. |
Четыре последние спецификация объединяет в семейство диаграмм взаимодействия. Полный перечень и правила – в нормативном приложении A спецификации.
На этом занятии – четыре диаграммы, которые отвечают на вопросы «кто и зачем пользуется системой» и «из чего она собрана»: вариантов использования, классов, компонентов и, короче, развёртывания и пакетов. Диаграммы поведения – деятельности, состояний, последовательности – на занятии 8. Любая из них собирается из одного и того же набора фигур и линий, и с него стоит начать.
3. Нотация: из чего состоят диаграммы
Нотация – набор стандартных символов и правил для диаграмм: азбука, где вместо букв – фигуры, линии и стрелки. Все элементы делятся на три группы: графические элементы (прямоугольники классов, овалы вариантов использования), связи (линии и стрелки разных видов) и специальные обозначения (метки вроде «interface» или кратности «1..*»).
3.1. Класс и объект
Класс – типовой объект или набор объектов с общими характеристиками и поведением, шаблон главной сущности системы: в онлайн-магазине это заказ, в онлайн-школе – студент. Изображается прямоугольником из трёх секций: имя, атрибуты (например, ID) и операции – то, что объект умеет (заказ создаётся и выполняется, студент записывается и сдаёт задания). Любую секцию можно скрыть, если она не нужна для разговора; на наброске часто остаётся одно имя.
Объект – конкретный экземпляр класса: выглядит так же, но имя подчёркнуто и записано в форме «имя : Класс», а вместо типов атрибутов стоят конкретные значения.
3.2. Интерфейс
Интерфейс – список операций, которые элемент обязуется выполнять, без указания, как именно. Представьте монитор с подписью «нажми эту кнопку – включусь, этот кабель вставь в устройство»: монитору всё равно, подключат ли к нему компьютер или приставку, – важно как. Интерфейс описывает набор доступных операций, а не того, кто ими пользуется, и это позволяет проектировать гибкую архитектуру без привязки к реализации. Рисуется двумя способами: как прямоугольник класса с ключевым словом «interface» над именем или как «леденец» – кружок на ножке; требуемый интерфейс – «гнездо», полукруг на ножке. От класса, который интерфейс выполняет, к нему ведёт пунктирная линия с пустым треугольником – реализация (подробнее в разделе 5.5).
3.3. Компонент и узел
Компонент – крупная заменяемая часть системы, отвечающая на вопрос «что делает система»: в сервисе доставки это, например, каталог и модуль оплаты. Обозначается прямоугольником со значком из двух маленьких выступов в правом верхнем углу либо ключевым словом «component»; с другими компонентами соединяется через интерфейсы – леденцы и гнёзда.
Узел – ещё более крупный элемент, объединяющий компоненты. Если компонент – «что делает система», то узел – «где она это делает»: серверы, базы данных, физические и виртуальные устройства. Изображается кубом; внутри куба показывают артефакты – файлы, которые на узле развёрнуты.
3.4. Вариант использования и актор
Вариант использования (use case, юзкейс) – цель, ради которой кто-то обращается к системе: сделать заказ, оплатить, посмотреть историю, отменить заказ. Изображается овалом с названием внутри; название – глагол с объектом.
Актор – действующее лицо рядом с системой: в «спектакле» онлайн-магазина участвуют покупатель и курьер. Рисуется человечком рядом с овалами, с которыми взаимодействует. Актор – это роль, а не человек: один и тот же студент утром играет роль покупателя, вечером – администратора. Актором может быть и другая система – банк, почтовый сервис, – и даже время, если что-то запускается по расписанию.
Почему актор – не класс и не объект? Потому что на диаграмме вариантов использования описывается, как работает система, а акторы – внешние участники: они взаимодействуют с системой, но не являются её частью. Всё, что внутри прямоугольника с именем системы, делает система; всё, что снаружи, – акторы.
3.5. Пакет и заметка
Пакет – способ группировки элементов (классов, компонентов, узлов) в логические блоки; пакеты можно вкладывать друг в друга, как папки. Изображается прямоугольником с закладкой сверху.
Заметка – поясняющий текст к элементам диаграммы: прямоугольник с загнутым уголком, похожий на стикер, привязанный к элементу пунктирной линией без стрелки.
3.6. Связи
- Ассоциация – актор взаимодействует с вариантом использования; сплошная линия без стрелок. Покупатель ассоциирован с «Оформить заказ».
- Включение («include») – обязательная общая часть; пунктирная стрелка от базового варианта к включаемому. «Оплатить заказ» включается в «Оформить заказ»: без оплаты оформление не завершится никогда.
- Расширение («extend») – необязательное дополнение по условию; пунктирная стрелка от расширения к базовому варианту. «Зарегистрироваться» расширяет «Оформить заказ»: новый покупатель зарегистрируется, постоянный пропустит шаг.
- Обобщение – наследование вариантов или акторов; сплошная линия с пустым треугольником у общего элемента. «Пользователь» обобщает «Покупателя» и «Администратора».
- Привязка заметки – пунктир без стрелки от заметки к элементу.
На диаграмме классов набор связей другой: ассоциация с кратностями, агрегация и композиция с ромбом, зависимость, реализация – о них в разделе 5.
3.7. Стереотипы, ограничения и рамка
Три специальных обозначения встречаются на любой диаграмме. Ключевые слова и стереотипы пишутся в кавычках-ёлочках над именем элемента: «interface», «component», «device»; так уточняют, что перед нами за элемент, не меняя его формы. Спецификация требует именно ёлочек, двойные угловые скобки <<…>> допустимы только там, где ёлочек нет в наборе символов. Актора, который не человек, принято рисовать прямоугольником со стереотипом «система» или «system», а не человечком. Ограничение записывается в фигурных скобках рядом с элементом: {время ответа < 2 с}, {abstract}. Рамка – необязательный прямоугольник вокруг диаграммы с ярлыком в левом верхнем углу: сокращение вида диаграммы и имя, например uc Интернет-магазин. Сокращения определены спецификацией: uc – вариантов использования, cmp – компонентов, dep – развёртывания, pkg – пакетов, act – деятельности, stm – состояний, sd – взаимодействия; для диаграммы классов пишут полное слово class.
Азбука собрана; проверить, насколько она запомнилась, можно на карточках.
Режим «изучение»: щёлкните карточку – на обороте название и назначение элемента. Режим «проверка»: показывается элемент и четыре варианта названия; серия из десяти верных ответов – выигранный раунд. Сыграйте против соседа: кто быстрее наберёт десять очков.
4. Диаграмма вариантов использования
Первая диаграмма, которую рисуют в любом проекте, – самая простая по нотации и самая трудная по смыслу. Нотации в ней четыре элемента: актор, овал, граница системы и три вида линий. Трудность в том, чтобы решить, кто снаружи, что внутри и что вообще считать целью. Этим и занимается раздел.
4.1. Как читать диаграмму
Диаграмма показывает, что пользователи могут делать в системе: зарегистрироваться, оформить заказ. Пользователи здесь – акторы, их цели – варианты использования. Диаграмма помогает понять, какие функции важны пользователю, и удобна для планирования требований: она показывает, что делает система, а не как.
| Элемент | Описание |
|---|---|
| Актор (actor) | Роль – человек, внешняя система или время, – взаимодействующая с системой. |
| Вариант использования (use case) | Действия системы, приводящие к наблюдаемому результату, ценному для актора. |
| Граница системы (subject) | Прямоугольник с именем системы в левом верхнем углу: внутри – варианты, снаружи – акторы. |
| Ассоциация | Участие актора в варианте использования; может иметь кратность. |
| Включение, расширение | Связи между вариантами использования (раздел 4.3). |
| Обобщение | Один актор или вариант – частный случай другого. |
4.2. Как найти акторов и цели
Диаграмма не рисуется с чистого листа – она извлекается из описания системы. Порядок такой.
- Назовите границу. Что делает наша система, а что – соседние: платёжный сервис, почта, магазин приложений. Всё соседнее станет акторами-системами.
- Выпишите роли. Кто получает от системы пользу и кто её обслуживает: покупатель, администратор, курьер. Роль – не должность и не конкретный человек; если две роли делают одно и то же, это одна роль; если одна роль делает всё, что делает другая, и ещё что-то, это обобщение.
- Для каждой роли – цели уровня «один присест». Вариант использования – то, ради чего актор садится за систему и с чем встаёт из-за неё через несколько минут с результатом: «оформить заказ», «вернуть книгу». Слишком общее («пользоваться магазином») – не вариант, а название системы; слишком мелкое («нажать кнопку», «ввести пароль») – шаг сценария, а не цель.
- Назовите глаголом с объектом. «Оформить заказ», а не «Заказ» и не «Оформление».
- Соедините и только потом ищите «include» и «extend». Сначала ассоциации актор – цель; связи между овалами добавляются в конце и лишь там, где их можно объяснить словами «всегда» или «иногда».
Время как актор – допустимая конвенция: «Таймер» или «Расписание» снаружи системы запускает «Напомнить о дедлайне». Аккуратнее другой вариант: записать запуск по времени как условие в тексте варианта и связать овал с тем, кому нужен результат. На одной диаграмме уместно от пяти до пятнадцати овалов; если их больше – делите по акторам или темам.
4.3. Включение, расширение, обобщение: когда что
Спецификация описывает три отношения точно, и ошибаются в них чаще всего.
Include – общая часть, которая выполняется всегда. Стрелка идёт от базового варианта к включаемому: базовый «знает», что без включаемого он не завершится. Включаемое поведение вставляется целиком и без условий. Пример из спецификации: «Снять наличные» включает «Проверить карту». Типичное применение – один общий шаг, нужный нескольким целям; если включаемый овал нужен только одному базовому и ни с кем больше не связан, включение, скорее всего, лишнее.
Extend – дополнение, которое бывает иногда. Стрелка идёт от расширения к базовому: базовый полон и осмыслен сам по себе и о расширении не знает. Условие расширения можно записать в заметке рядом со стрелкой. Пример: «Напечатать чек» расширяет «Снять наличные» – если клиент попросил.
Обобщение соединяет элементы одного вида: актор с актором, вариант с вариантом. Частный актор наследует все связи общего: если «Зарегистрированный пользователь» обобщён до «Гостя», он может всё, что может гость, и ещё что-то.
Между акторами допустимо только обобщение; между вариантами одного и того же субъекта – только include, extend и обобщение, простой ассоциацией два овала соединять нельзя.
4.4. Типичные ошибки
Исследование студенческих проектов 2006 года насчитало в четырнадцати командных работах 380 ошибок и показало, что самые частые – не в синтаксисе, а в смысле. Список ниже – из этого исследования и каталога антипаттернов 2010 года; его стоит держать перед глазами, когда проверяете свою диаграмму.
- Функциональная декомпозиция. Шаги одного сценария разложены по овалам и связаны «include»: «Ввести адрес», «Выбрать доставку», «Подтвердить». Это не цели актора, а пункты одного варианта; им место в тексте сценария. Неверные связи между вариантами встречались в 64 % проектов, почти все – с «extend».
- Ручная операция как вариант использования. «Упаковать посылку» делает курьер руками, система в этом не участвует – 57 % проектов.
- Детали интерфейса и базы данных. «Нажать кнопку», «Сохранить в таблицу» – шаги реализации, а не цели.
- Часть системы как актор. База данных, модель распознавания, сервер, физический движок – внутри границы, а не снаружи; актор по определению взаимодействует с системой извне.
- Актор внутри границы и ассоциация между акторами – нарушения нотации.
- Перевёрнутые стрелки. Студенты знают определения «include» и «extend», но путают направление; проверка – «правило двух слов» из раздела 4.3.
- «Войти в систему» как самостоятельная цель. Никто не садится за систему, чтобы войти. Либо это общий шаг, включаемый из нескольких вариантов, либо предусловие в тексте. Спор о нём честный: спецификация сама использует «Проверить карту» как включаемый вариант.
4.5. Диаграмма – оглавление к тексту
Овал умещает три слова, а чтобы программист реализовал «Оформить заказ», нужен сценарий: кто начинает, что должно быть выполнено до начала, какие шаги идут по порядку, где возможны отклонения, чем всё заканчивается. Поэтому диаграмма вариантов использования – оглавление к набору коротких текстов, по одному на овал, и усилия стоит вкладывать в тексты. Удобный минимальный шаблон:
| Поле | Пример для «Оформить заказ» |
|---|---|
| Актор | Покупатель |
| Предусловие | В корзине есть хотя бы один товар |
| Основной сценарий | 1. Покупатель открывает корзину. 2. Система показывает состав и сумму. 3. Покупатель указывает адрес. 4. Система предлагает способы доставки. 5. Покупатель выбирает способ и подтверждает. 6. Система создаёт заказ и переходит к оплате («Оплатить заказ»). |
| Расширения | 3а. Адрес не в зоне доставки – система предлагает самовывоз. |
| Результат | Заказ создан и ждёт оплаты |
Такие тексты лежат рядом с диаграммой в репозитории – в папке с документацией или прямо в README. Диаграмма отвечает на вопрос «кто и зачем», тексты – «как»; следующий вопрос – «из чего», и на него отвечает диаграмма классов.
5. Диаграмма классов
Самая популярная диаграмма UML: основные «кирпичики» системы – классы, их атрибуты, операции и связи, включая ограничения на связи. Используется и при проектировании кода, и в бизнес-моделировании. Начнём с примера, затем разберём синтаксис по частям.
5.1. Пример
Читается диаграмма так: заказ состоит из позиций, и позиция не существует вне заказа; каждая позиция ссылается ровно на один товар, а товар может входить в любое число позиций; покупатель – частный случай пользователя; у покупателя может быть много заказов, у заказа – один покупатель.
5.2. Атрибуты и операции: синтаксис
На наброске в секциях класса пишут что угодно – «цена», «оформить». В чертеже и в коде, который генерирует нейросеть, записи подчиняются синтаксису спецификации.
Атрибут записывается как видимость имя : тип [кратность] = значение {свойства}; обязательно только имя. Видимость обозначается одним знаком: + открытый, - закрытый, # защищённый, ~ пакетный. Операция – видимость имя(параметры) : тип результата; параметры записываются так же, как атрибуты. Статические атрибуты и операции подчёркиваются, имя абстрактного класса пишется курсивом или с пометкой {abstract}. Косая черта перед именем атрибута означает производный атрибут – вычисляемый из других, как сумма заказа из позиций.
5.3. Ассоциации и кратности
Ассоциация – отношение между экземплярами классов. У каждого её конца есть кратность: сколько объектов этого класса может участвовать в отношении с одним объектом другого.
| Запись | Смысл |
|---|---|
1 | ровно один |
0..1 | ноль или один |
* или 0..* | сколько угодно, в том числе ни одного |
1..* | хотя бы один |
2..5 | от двух до пяти |
Если кратность на диаграмме не показана, о модели ничего заключить нельзя – это не «один». Кроме кратностей, у ассоциации бывают имя (глагол: «делает»), роли на концах («заказчик», «заказы») и стрелка навигации – она показывает, что от покупателя можно дойти до его заказов, а обратный путь не предусмотрен.
5.4. Агрегация и композиция
Оба отношения – «целое – часть», и ромб в обоих ставится у целого.
Композиция (закрашенный ромб) – строгая: часть принадлежит не более чем одному целому одновременно, и удаление целого удаляет части. Дом и комнаты, заказ и его позиции. Агрегация (пустой ромб) – нестрогая: части живут и отдельно, целое лишь собирает их. Кружок и студенты, плейлист и песни. Любопытно, что спецификация точный смысл агрегации намеренно не задаёт – он «зависит от области и моделировщика», – поэтому в наброске пустой ромб часто заменяют обычной ассоциацией, а композицию оставляют там, где она значима.
5.5. Интерфейсы, реализация и зависимость
Интерфейс (раздел 3.2) появляется на диаграмме классов в двух записях.
- Реализация – пунктирная линия с пустым треугольником от класса к интерфейсу: класс выполняет контракт.
- Зависимость – пунктирная стрелка с открытым наконечником от того, кто зависит, к тому, от кого зависят; ключевое слово «use» уточняет, что зависимость – через вызов операций. Изменение интерфейса может затронуть «Кассу», но не наоборот.
- Леденец и гнездо – та же пара короче: кружок – предоставляемый интерфейс, полукруг – требуемый, их совмещение – соединение.
Кто прошёл траекторию «Геймдев», узнает здесь инверсию зависимостей из конспекта A10: класс зависит от интерфейса, а не от конкретной реализации, и реализацию можно подменить.
5.6. Диаграмма объектов
Диаграмма классов говорит о типах, диаграмма объектов – о конкретном моменте: один заказ, одна позиция, один товар. Имена подчёркнуты, вместо типов – значения, линии без кратностей. Такой снимок удобен, когда диаграмма классов с кратностями кажется абстрактной: объекты показывают, как она выглядит «в жизни».
5.7. Типичные ошибки
- Таблицы вместо понятий. Класс «ЗаказТовар» с полями-ключами – это схема базы данных, а не модель предметной области; в анализе классы – понятия, в проектировании – типы кода, смешивать уровни не стоит.
- Кратности нет или перевёрнута. Половина студенческих проектов в исследовании 2006 года содержала такую ошибку. Читайте каждую вслух: «у одного заказа – одна или больше позиций».
- Атрибут в чужом классе. «адрес доставки» в классе «Товар» – признак того, что класс отвечает не за своё.
- Обобщение ради обобщения. Подкласс без собственных атрибутов и операций не нужен.
- Цикл из композиций. Целое не может быть частью своей части.
Классы описывают внутренности программы. Чтобы увидеть её снаружи – из каких модулей и серверов она собрана, – нужны диаграммы архитектуры.
6. Диаграммы архитектуры: компоненты, развёртывание, пакеты
Три диаграммы этого раздела отвечают на вопросы «из каких крупных частей собрана система», «где эти части работают» и «как сгруппирован код». В отчёте они обычно занимают по одной странице в главе о проектировании.
6.1. Диаграмма компонентов
Показывает, из каких крупных частей собрана система и кто от кого зависит. Элементы – уже знакомые компоненты (раздел 3.3), а связывают их интерфейсы в «розеточной» нотации.
Читается схема так: «Интерфейс игры» не знает, как устроен «Движок», – ему достаточно операций контракта IEngine; движок, в свою очередь, пользуется «Сохранениями» через ISave. Замените компонент «Сохранения» (файлы → облако), сохранив контракт, – остальная система не заметит подмены. У компонента бывают порты – маленькие квадраты на границе, через которые идут интерфейсы; на наброске их обычно опускают.
6.2. Диаграмма развёртывания
Отвечает на вопрос «где»: на каких устройствах и в каких средах выполнения живут части системы. Узлы-кубы бывают двух видов: устройство («device» – ноутбук, сервер, телефон) и среда выполнения («executionEnvironment» – интерпретатор Python, браузер, контейнер); среда рисуется внутри устройства. Внутри узлов – артефакты: файлы программы, библиотеки, образы. Линии между узлами – пути связи, подписанные протоколом.
Для учебного проекта такая диаграмма – ответ на вопрос комиссии «а где это всё запускается»: ноутбук студента, сервер приложения, сервер базы данных, при необходимости – сервер с видеокартой для модели.
6.3. Диаграмма пакетов
Группирует элементы системы в пакеты и показывает зависимости между ними. Пакет – «папка» с закладкой; зависимость – пунктирная стрелка с ключевым словом «import». Диаграмма встречается реже прочих и полезна в больших проектах, где модулей много: по ней видно, что «Оплата» знает о «Заказах», а «Каталог» ни о ком не знает – и значит, его можно переиспользовать.
Три архитектурные диаграммы вместе с диаграммами вариантов использования и классов – полный набор «статики». Осталось выбрать, чем их рисовать.
7. Инструменты: редактор курса, draw.io, PlantUML и Mermaid
Инструменты делятся на два семейства: графические, где элементы расставляют мышью, и текстовые, где диаграмму описывают кодом, а раскладку считает программа. У каждого семейства свои сильные стороны, и в проекте пригодятся оба.
7.1. Редактор диаграмм курса
Прямо на этой странице работает редактор UML-диаграмм: палитра элементов слева, холст в середине, свойства выделенного элемента справа. Он умеет всё, что нужно для занятий 7 и 8: элементы структурных диаграмм и диаграмм поведения, связи всех видов нотации, правку текста по двойному щелчку, отмену, сохранение в JSON и открытие из него, экспорт в PNG, JPEG и SVG, проверку нотации и галерею примеров. Внутри страницы редактор тесноват – для работы удобнее открыть его в отдельном окне кнопкой над холстом.
Как работать:
- Добавить элемент – перетащите его из палитры на холст или щёлкните по нему.
- Соединить – выделите элемент и потяните за оранжевый кружок на его правом краю к другому элементу. Тип связи выбирается в списке «тип связи» сверху и меняется в свойствах. Направление – от того, с которого начали: «include» – от базового к включаемому, «extend» – от расширения к базовому, обобщение – от частного к общему, композиция – от целого к части.
- Править текст – двойной щелчок; у класса двойной щелчок по секции атрибутов или операций правит её. В свойствах справа – стереотип, абстрактность, подписи и кратности на концах связи.
- Сохранить – «Сохранить JSON» даёт файл диаграммы, который снова откроется в редакторе (кнопка «Открыть…» или перетаскивание файла на холст); PNG и JPEG – картинка для отчёта и README. Черновик хранится в браузере и восстанавливается при следующем открытии.
- Проверить нотацию – редактор находит актора внутри границы, «include» к актору, элемент без связей и другие ошибки формы. Смысл он не проверяет: что должно быть на диаграмме, решает команда.
- Примеры – меню с готовыми диаграммами простых систем: магазин, банкомат, библиотека, компоненты игры, развёртывание веб-сервиса, пакеты; для занятия 8 – состояния заказа, деятельность и последовательность. Пример можно менять и сохранять как свой.
7.2. draw.io
draw.io – бесплатный графический редактор, который работает в браузере без регистрации, а в виде draw.io Desktop – и без сети; исходный код открыт. Библиотека фигур «UML 2.5» включает все четырнадцать видов диаграмм, шаблоны лежат в меню вставки. Файл .drawio – обычный XML, его можно хранить в репозитории; экспорт в PNG и SVG умеет встраивать исходник диаграммы в картинку, и такой .drawio.png одновременно показывается в README как рисунок и открывается в редакторе для правки. Для занятий курса это основной «взрослый» инструмент, если редактора страницы окажется мало.
7.3. Текст вместо мыши: PlantUML и Mermaid
Текстовые нотации описывают диаграмму кодом. Выигрыш – в репозитории: текст сравнивается в pull request построчно, конфликты сливаются, а нейросеть читает и пишет такой код напрямую. Плата – раскладку считает программа, и подвинуть овал мышью нельзя.
PlantUML – старший из двух: умеет все диаграммы UML, включая компоненты, развёртывание, объекты и класс-ассоциации. Работает на Java; для структурных диаграмм ему нужен Graphviz, который в Windows встроен в сборку, а в Linux и macOS ставится отдельно, – отсюда главный «нюанс»: последовательность рисуется, а классы нет, пока не поставлен Graphviz. Удобнее всего расширение PlantUML для VS Code с режимом сервера. В README на GitHub код PlantUML так и остаётся кодом: GitHub его не рисует.
Mermaid работает в браузере и рисуется прямо в Markdown на GitHub с февраля 2022 года – в README, issues и pull request, – а также в GitLab, Obsidian и Notion. Диаграммы классов есть давно; диаграммы вариантов использования появились в версии 12.0 (сентябрь 2026) под ключевым словом usecase-beta. Компонентов, развёртывания и объектов в Mermaid нет.
Одна и та же диаграмма вариантов использования в двух нотациях:
@startuml
left to right direction
actor Покупатель
actor Администратор
rectangle "Интернет-магазин" {
usecase "Оформить заказ" as UC1
usecase "Оплатить заказ" as UC2
usecase "Зарегистрироваться" as UC3
usecase "Управлять каталогом" as UC4
}
Покупатель --> UC1
Покупатель --> UC3
Администратор --> UC4
UC1 ..> UC2 : <<include>>
UC3 ..> UC1 : <<extend>>
@endumlusecase-beta
direction LR
actor Customer("Покупатель")
actor Admin("Администратор")
systemBoundary "Интернет-магазин"
Checkout("Оформить заказ")
Payment("Оплатить заказ")
SignUp("Зарегистрироваться")
Catalog("Управлять каталогом")
end
Customer --> Checkout
Customer --> SignUp
Admin --> Catalog
Checkout ..> : include Payment
SignUp ..> : extend CheckoutИ диаграмма классов из раздела 5.1:
@startuml
abstract class Пользователь {
# логин : String
# почта : String
+ войти()
}
class Заказ {
- id : int
- дата : Date
+ оформить()
+ сумма() : Money
}
class ПозицияЗаказа {
- количество : int
}
class Товар
Заказ "1" *-- "1..*" ПозицияЗаказа
ПозицияЗаказа "*" --> "1" Товар
Пользователь <|-- Покупатель
Пользователь <|-- Администратор
Покупатель "1" -- "*" Заказ : делает
@endumlclassDiagram
class User {
<<abstract>>
#String login
#String email
+login()
}
class Order {
-int id
-Date date
+checkout()
+total() Money
}
class OrderItem {
-int quantity
}
class Product
Order "1" *-- "1..*" OrderItem
OrderItem "*" --> "1" Product
User <|-- Customer
User <|-- Admin
Customer "1" -- "*" Order : makesВ Mermaid тип пишется перед именем, как в Java, а не через двоеточие, как в UML; это одно из мелких расхождений, которые стоит знать, читая чужой код.
Каким бы инструментом ни пользоваться, начинать стоит с одной диаграммы своей системы – ей и посвящён практикум.
8. Практикум: диаграмма вариантов использования своей системы
Практикум идёт в два круга: сначала на доске с бумажными карточками, затем в редакторе. Карточки – акторы, варианты использования, граница системы, заметки – выдаются командам вместе с описанием системы. Среди карточек есть ловушки: части системы, выдающие себя за акторов, и шаги интерфейса, выдающие себя за цели. Единственно правильной раскладки нет: диаграммы команд сравниваются не с эталоном, а по чек-листу, и расхождения – повод для разговора, а не ошибка.
8.1. На доске
Команда получает описание системы и набор карточек. Порядок работы:
- Граница. Нарисовать на доске прямоугольник и прикрепить полоску с названием системы в его левый верхний угол. Обсудить, что внутри, что снаружи.Результатпрямоугольник с именем.
- Акторы. Разобрать карточки-акторы: роли снаружи границы – слева и справа от неё, ловушки (части системы, устройства) – в сторону с объяснением.Результатакторы вокруг границы.
- Цели. Разобрать карточки-варианты: цели уровня «один присест» – внутри, шаги интерфейса и внутренние операции – в сторону.Результатовалы внутри границы.
- Ассоциации. Соединить маркером каждого актора с его целями; актор без линии или овал без актора – повод перепроверить.Результатвсе элементы связаны.
- Include и extend. Только теперь – пунктир между овалами, с подписью-карточкой и проверкой «правилом двух слов». Обобщение акторов – там, где один умеет всё, что умеет другой.Результатне больше трёх-четырёх пунктиров.
- Защита. Один участник за две минуты объясняет диаграмму другой команде; та задаёт вопросы по чек-листу.Результаттри замечания от соседей.
8.2. В редакторе
Те же наборы карточек лежат в редакторе: выберите тему команды, и карточки появятся в лотке внизу холста – их перетаскивают на холст, а связи рисуют мышью, выбирая тип из нотации. Описание системы открывается кнопкой «Описание системы». Команда работает за одним компьютером, обсуждая каждую карточку; удалённая с холста карточка возвращается в лоток, а свои элементы добавляются кнопкой «+ свой элемент».
8.3. Домашнее задание
Задание одно: описать варианты использования своей системы.
- Диаграмма вариантов использования своей системы – в редакторе или в draw.io: файл диаграммы (JSON или .drawio) и картинка PNG в папке
docs/diagramsрепозитория команды.Результатдва файла в репозитории. - Тексты трёх главных вариантов использования по шаблону раздела 4.5 – в
docs/use-cases.md.Результаттри сценария с расширениями.
Работа принимается, если:
- на диаграмме есть граница системы, все акторы снаружи и связаны с целями, а каждую стрелку «include» и «extend» команда объясняет словами «всегда» или «иногда»;
- у каждого из трёх текстов есть актор, предусловие, основной сценарий, хотя бы одно расширение и результат, и тексты согласуются с диаграммой.
Описанные варианты использования станут первыми страницами отчёта – главой о требованиях. Нарисованное за час на доске экономит страницы текста потом.
9. Свод практик
Правила занятия собраны вместе: на лицевой стороне карточки – само правило, на обороте – как его применять.
Диаграмма вообще
Варианты использования
Классы и архитектура
Инструменты
Контрольные вопросы
-
Unified Modeling Language. Unified – унифицированный: снял различия между нотациями прежних методов и дал единую точку зрения на разные системы и фазы разработки; Modeling – диаграммы являются моделями из связанных графических объектов; Language – искусственный язык со словарём, семантикой и синтаксисом.
-
Структурные описывают систему статически – из чего она состоит (классы, объекты, пакеты, компоненты, развёртывание); поведенческие – динамически, как она живёт во времени (варианты использования, деятельность, состояния, взаимодействия).
-
Диаграмма, нарисованная за минуты ради одного разговора: выборочная, неточная, одна страница. Учебной команде нужно договориться и записать решение, а не вести полную модель, которая стареет вместе с кодом.
-
Имя, атрибуты, операции. Атрибут: видимость, имя, двоеточие и тип, кратность в квадратных скобках, значение по умолчанию после знака равенства; обязательно только имя.
-
Диаграмма вариантов использования описывает работу системы, а акторы – внешние роли: они взаимодействуют с системой, инициируют варианты использования, но её частью не являются; всё, что внутри границы, делает система.
-
Include – обязательная общая часть, выполняется всегда, стрелка от базового варианта к включаемому. Extend – необязательное дополнение по условию, стрелка от расширения к базовому; базовый о расширении не знает и без него полон.
-
Это шаги одного сценария «Оформить заказ», а не цели актора; разложенные по овалам и связанные «include», они дают функциональную декомпозицию – самую частую ошибку новичков. Их место – в тексте сценария.
-
Обе – «целое – часть» с ромбом у целого. При композиции (закрашенный ромб) часть принадлежит одному целому и уничтожается вместе с ним; при агрегации (пустой ромб) части живут отдельно, а точный смысл спецификация оставляет моделировщику.
-
Ничего: о модели нельзя сделать вывод. Это не «один» и не «много» – кратность нужно написать.
-
Леденец (кружок на ножке) – предоставляемый интерфейс: операции, которые компонент предлагает другим. Гнездо (полукруг) – требуемый интерфейс: операции, которые компоненту нужны. Их совмещение – соединение компонентов через контракт.
-
Устройство («device») – физическая или виртуальная машина: сервер, ноутбук. Среда выполнения («executionEnvironment») – программа, внутри которой работают артефакты: интерпретатор, браузер, контейнер; рисуется внутри устройства.
-
Mermaid рисуется в Markdown на GitHub с 2022 года (классы, варианты использования с версии 12, состояния, последовательность). PlantUML в README остаётся кодом; для него нужны расширение редактора или сервер.
-
Акторов (лишние, пропущенные, части системы снаружи), направление и уместность «include» и «extend», выдуманные элементы, кратности и связи между классами; сверять с описанием системы по чек-листу, а не глазами.
Источники
Стандарты и документы OMG
- OMG Unified Modeling Language (OMG UML). Version 2.5.1 : OMG Document formal/2017-12-05 / Object Management Group. – Needham : OMG, 2017. – 796 p. – URL: https://www.omg.org/spec/UML/2.5.1/PDF (дата обращения: 25.10.2026). – Текст : электронный.
- Unified Modeling Language (UML) : specification page / Object Management Group. – URL: https://www.omg.org/spec/UML/ (дата обращения: 25.10.2026). – Текст : электронный.
- UML Summary. Version 1.1 : OMG document ad/97-08-03 / Rational Software, Microsoft, Hewlett-Packard [et al.]. – [S. l.], 1997. – 23 p. – URL: https://www.omg.org/cgi-bin/doc?ad/97-08-03.pdf (дата обращения: 25.10.2026). – Текст : электронный.
- ISO/IEC 19505-2:2012. Information technology – Object Management Group Unified Modeling Language (OMG UML) – Part 2: Superstructure. – Geneva : ISO/IEC, 2012. – URL: https://www.iso.org/standard/52854.html (дата обращения: 25.10.2026). – Текст : электронный.
Книги
- Буч, Г. Язык UML. Руководство пользователя / Г. Буч, Д. Рамбо, И. Якобсон ; пер. с англ. Н. Мухина. – 2-е изд. – Москва : ДМК Пресс, 2006. – 496 с. – ISBN 5-94074-334-X. – Текст : непосредственный.
- Фаулер, М. UML. Основы. Краткое руководство по стандартному языку объектного моделирования / М. Фаулер ; пер. с англ. – 3-е изд. – Санкт-Петербург : Символ-Плюс, 2005. – 192 с. – ISBN 5-93286-060-X. – Текст : непосредственный.
- Леоненков, А. В. Самоучитель UML 2 / А. В. Леоненков. – Санкт-Петербург : БХВ-Петербург, 2007. – 576 с. – ISBN 978-5-94157-878-8. – Текст : непосредственный.
- Ларман, К. Применение UML 2.0 и шаблонов проектирования : введение в объектно-ориентированный анализ, проектирование и итеративную разработку / К. Ларман ; пер. с англ. – 3-е изд. – Москва : Вильямс, 2007. – 727 с. – ISBN 978-5-8459-1185-8. – Текст : непосредственный.
- Коберн, А. Современные методы описания функциональных требований к системам / А. Коберн ; пер. с англ. Е. Борисова. – Москва : Лори, 2002. – 263 с. – ISBN 5-85582-152-8. – Текст : непосредственный.
- Fowler, M. UML Distilled: A Brief Guide to the Standard Object Modeling Language / M. Fowler. – 3rd ed. – Boston : Addison-Wesley, 2003. – 208 p. – ISBN 0-321-19368-7. – Текст : непосредственный.
- Cockburn, A. Writing Effective Use Cases / A. Cockburn. – Boston : Addison-Wesley, 2001. – 270 p. – ISBN 0-201-70225-8. – Текст : непосредственный.
- Ambler, S. W. The Elements of UML 2.0 Style / S. W. Ambler. – Cambridge : Cambridge University Press, 2005. – DOI 10.1017/CBO9780511817533. – Текст : непосредственный.
Статьи и исследования
- Petre, M. UML in practice / M. Petre. – Текст : электронный // Proceedings of the 35th International Conference on Software Engineering (ICSE 2013). – IEEE, 2013. – P. 722–731. – DOI 10.1109/ICSE.2013.6606618.
- Bolloju, N. Assisting novice analysts in developing quality conceptual models with UML / N. Bolloju, F. S. K. Leung. – Текст : электронный // Communications of the ACM. – 2006. – Vol. 49, № 7. – P. 108–112. – DOI 10.1145/1139922.1139926.
- El-Attar, M. Improving the quality of use case models using antipatterns / M. El-Attar, J. Miller. – Текст : электронный // Software & Systems Modeling. – 2010. – Vol. 9, № 2. – P. 141–160. – DOI 10.1007/s10270-009-0112-9.
- Chren, S. Mistakes in UML Diagrams: Analysis of Student Projects in a Software Engineering Course / S. Chren, B. Buhnova, M. Macak, L. Daubner, B. Rossi. – Текст : электронный // 2019 IEEE/ACM 41st International Conference on Software Engineering: Software Engineering Education and Training (ICSE-SEET). – IEEE, 2019. – P. 100–109. – DOI 10.1109/ICSE-SEET.2019.00019.
- Beck, K. A laboratory for teaching object-oriented thinking / K. Beck, W. Cunningham. – Текст : электронный // ACM SIGPLAN Notices. – 1989. – Vol. 24, № 10. – P. 1–6. – DOI 10.1145/74877.74879.
- Cherubini, M. Let's go to the whiteboard: how and why software developers use drawings / M. Cherubini, G. Venolia, R. DeLine, A. J. Ko. – Текст : электронный // Proceedings of the SIGCHI Conference on Human Factors in Computing Systems (CHI '07). – ACM, 2007. – P. 557–566. – DOI 10.1145/1240624.1240714.
- Cámara, J. On the assessment of generative AI in modeling tasks: an experience report with ChatGPT and UML / J. Cámara, J. Troya, L. Burgueño, A. Vallecillo. – Текст : электронный // Software and Systems Modeling. – 2023. – Vol. 22, № 3. – P. 781–793. – DOI 10.1007/s10270-023-01105-5.
- Chen, K. Automated Domain Modeling with Large Language Models: A Comparative Study / K. Chen, Y. Yang, B. Chen, J. A. Hernández López, G. Mussbacher, D. Varró. – Текст : электронный // 2023 ACM/IEEE 26th International Conference on Model Driven Engineering Languages and Systems (MODELS). – IEEE, 2023. – P. 162–172. – DOI 10.1109/MODELS58315.2023.00037.
- Wang, B. How LLMs Aid in UML Modeling: An Exploratory Study with Novice Analysts / B. Wang, C. Wang, P. Liang, B. Li, C. Zeng. – Текст : электронный // 2024 IEEE International Conference on Software Services Engineering (SSE). – IEEE, 2024. – arXiv:2404.17739. – URL: https://arxiv.org/abs/2404.17739 (дата обращения: 25.10.2026).
- Krishnan, G. S. N. Comparative Analysis of Large Language Models for Automated Use Case Diagram Generation / G. S. N. Krishnan, S. Ambadi, M. G. Thushara. – Текст : электронный // Proceedings of the 3rd International Conference on Futuristic Technology (INCOFT 2025). – SCITEPRESS, 2025. – Vol. 2. – P. 465–471. – DOI 10.5220/0013594700004664.
- Jiang, X. Self-Planning Code Generation with Large Language Models / X. Jiang [et al.]. – Текст : электронный // ACM Transactions on Software Engineering and Methodology. – 2024. – Vol. 33, № 7. – P. 1–30. – DOI 10.1145/3672456.
- Fowler, M. UmlMode / M. Fowler. – Текст : электронный // martinfowler.com. – 2003. – 28 May. – URL: https://martinfowler.com/bliki/UmlMode.html (дата обращения: 25.10.2026).
- Henney, K. The pros and cons of use case diagrams / K. Henney. – Текст : электронный // TechTarget. – 2007. – 24 Sept. – URL: https://www.techtarget.com/searchsoftwarequality/news/1273406/The-pros-and-cons-of-use-case-diagrams (дата обращения: 25.10.2026).
- Ambler, S. W. UML 2 Use Case Diagramming Guidelines / S. W. Ambler. – Текст : электронный // Agile Modeling. – URL: http://agilemodeling.com/style/useCaseDiagram.htm (дата обращения: 25.10.2026).
Документация инструментов
- Fakhroutdinov, K. UML Use Case Diagrams ; UML Class Diagram Reference ; UML Component Diagrams ; UML Deployment Diagrams ; UML Package Diagrams / K. Fakhroutdinov. – Текст : электронный // uml-diagrams.org. – URL: https://www.uml-diagrams.org/use-case-diagrams.html ; https://www.uml-diagrams.org/class-reference.html ; https://www.uml-diagrams.org/component-diagrams.html ; https://www.uml-diagrams.org/deployment-diagrams.html ; https://www.uml-diagrams.org/package-diagrams.html (дата обращения: 25.10.2026).
- draw.io : [официальный сайт и документация]. – Текст : электронный. – URL: https://www.drawio.com/ ; https://www.drawio.com/doc/faq/save-file-formats ; https://www.drawio.com/blog/uml-2-5 (дата обращения: 25.10.2026).
- jgraph/drawio-desktop : Official electron build of draw.io : [репозиторий GitHub]. – Текст : электронный. – URL: https://github.com/jgraph/drawio-desktop (дата обращения: 25.10.2026).
- Диаграмма вариантов использования ; Диаграмма классов ; GraphViz/DOT ; Начало работы : [документация PlantUML]. – Текст : электронный. – URL: https://plantuml.com/ru/use-case-diagram ; https://plantuml.com/ru/class-diagram ; https://plantuml.com/ru/graphviz-dot ; https://plantuml.com/ru/starting (дата обращения: 25.10.2026).
- PlantUML : расширение для Visual Studio Code / jebbs. – Текст : электронный. – URL: https://marketplace.visualstudio.com/items?itemName=jebbs.plantuml (дата обращения: 25.10.2026).
- Use case diagrams (12.0.0+) ; Class diagrams : [документация Mermaid]. – Текст : электронный. – URL: https://mermaid.js.org/syntax/usecase.html ; https://mermaid.js.org/syntax/classDiagram.html (дата обращения: 25.10.2026).
- Woodward, M. Include diagrams in your Markdown files with Mermaid / M. Woodward, A. Biagianti. – Текст : электронный // The GitHub Blog. – 2022. – 14 Feb. – URL: https://github.blog/developer-skills/github/include-diagrams-markdown-files-mermaid/ (дата обращения: 25.10.2026).
- Creating diagrams // GitHub Docs : [сайт]. – Текст : электронный. – URL: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams (дата обращения: 25.10.2026).
Статьи на Хабре
- avecoder. Что находится между идеей и кодом? Обзор 14 диаграмм UML / avecoder. – Текст : электронный // Хабр. – 2020. – 29 июня. – URL: https://habr.com/ru/articles/508710/ (дата обращения: 25.10.2026).
- avecoder. UML для самых маленьких: диаграмма классов / avecoder. – Текст : электронный // Хабр. – 2020. – 20 июля. – URL: https://habr.com/ru/articles/511798/ (дата обращения: 25.10.2026).
- UML для разработчиков. – Текст : электронный // Хабр : блог компании «Программный Продукт». – 2020. – 5 марта. – URL: https://habr.com/ru/company/ppr/blog/491146/ (дата обращения: 25.10.2026).
- Garbarino, E. UML умер, а никто и не заметил? / E. Garbarino ; пер. с англ. – Текст : электронный // Хабр : блог компании VDSina. – 2021. – 6 июня. – URL: https://habr.com/ru/companies/vdsina/articles/561272/ (дата обращения: 25.10.2026).
- Кузнецова, Н. Диаграммы без боли и страданий: PlantUML / Н. Кузнецова. – Текст : электронный // Хабр : блог компании «Альфа-Банк». – 2023. – 14 июня. – URL: https://habr.com/ru/companies/alfa/articles/740518/ (дата обращения: 25.10.2026).
- Кнышенко, М. Разговорный UML: как говорить с командой на одном языке / М. Кнышенко. – Текст : электронный // Хабр : блог компании «Рунити». – 2025. – 7 авг. – URL: https://habr.com/ru/companies/runity/articles/935050/ (дата обращения: 25.10.2026).
- Валитова, Д. Основы UML. Кому и зачем он нужен / Д. Валитова. – Текст : электронный // Systems Education : [сайт]. – URL: https://systems.education/who-uses-uml (дата обращения: 25.10.2026).
- UML-диаграммы: что это, какие бывают и как их использовать. – Текст : электронный // Weeek : [сайт]. – URL: https://weeek.net/ru/blog/uml-diagrams (дата обращения: 25.10.2026).